This implementation is experimental and will probably change.

tagQuery(tags) methods

Select

• $find(cssSelector): Find all tag elements matching the multi-element cssSelector
• $children(cssSelector = NULL): Update the selected elements to the selected elements direct children.
• $parent(cssSelector = NULL): Update the selected elements to the selected elements direct parents.
• $parents(cssSelector = NULL): Update the selected elements to all ancestors of the selected elements.
• $closest(cssSelector = NULL): Update the selected elements to closest ancestor (and including itself) of each of the selected elements.
• $siblings(cssSelector = NULL): Get the siblings of each element in the set of matched elements.
• $filter(fn): Update the selected elements if fn(selected_i) returns TRUE
• $reset(): Resets the selected elements to the top level (root) tags.

Update

• $addClass(class): Apps class(es) to each of the the selected elements.
• $removeClass(class): Removes a set of class values from all of the selected elements.
• $hasClass(class): Determine whether the selected elements have a given class. Returns a vector of logical values.
• $toggleClass(class): If the a class value is missing, add it. If a class value already exists, remove it.
• $addAttrs(...): Add named attributes to all selected children. Similar to [tagAppendAttributes()].
• $removeAttrs(attrs): Removes the provided attributes in each of the selected elements.
• $emptyAttrs(): Removes all attributes in each of the selected elements.
• $hasAttr(attr): Returns a vector whose values are whether the selected element contains the non-NULL attribute.

Adjust children

• $append(...): Add all ... objects as children after any existing children to the selected elements. Similar to [tagAppendChildren()]
• $prepend(...): Add all ... objects as children before any existing children to the selected elements. A variation of [tagAppendChildren()]
• $empty(): Remove all children in the selected elements. Use this method before calling $append(...) to replace all selected elements' children.

Adjust siblings

• $after(...): Add all ... objects as siblings after each of the selected elements.
• $before(...): Add all ... objects as siblings before each of the selected elements.
• $replaceWith(...): Replace all selected elements with .... This also sets the selected elements to an empty set.
• $remove(...): Remove all selected elements from the tagQuery() object. The selected elements is set to an empty set.

Generic methods

• $each(fn): Perform function fn on each of the selected elements.

Tag Query methods

• $asTags(selected = TRUE): Converts all tag environments to tags.
• $root(): Return all top level (root) tags environments.
• $selected(): Returns a list of selected tag environments.
• $get(position): Returns the selected tag element at the position position.
• $rebuild(): Makes sure that all tags have been upgraded to tag environments.
• $print(): Internal print method. Called by print.htmltools.tag.query()

Current tag env design decisions

• Tag graphs or tag environments can NOT be used in UI. These objects MUST be converted back to standard tag objects.
• tagFunctions will not be altered in place